home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
PROGRAM
/
CKEYTREE.ARJ
/
README.DOC
< prev
next >
Wrap
Text File
|
1992-05-11
|
7KB
|
149 lines
KEYTREE UTILITIES VERSION 3.1 - MAY 1992 (Copyright Rewse Consultants Ltd)
__________________________________________________________________________
┌─────────┐
┌─────┴───┐ │ (R)
──│ │o │──────────────────
│ ┌─────┴╨──┐ │ Association of
│ │ │─┘ Shareware
└───│ o │ Professionals
──────│ ║ │────────────────────
└────╨────┘ MEMBER
_____________________________________________________________________________
The KeyTree Utilities is a set of library routines for C programmers for the
creation, access and maintenance of indexed files of variable length records.
The files that should be on this disk are :
README.DOC - this file
KEYTREE3.C - the source code of the KeyTree Utilities
KTERROR.C - plain language version of KeyTree exception codes
KTREE3.H - definitions of the KeyTree commands
TUTOR.EXE - a tutorial program which allows you to create simple
files and access them using the utilities
NAMES.FIL - a simple file which can be used by TUTOR.EXE
MANUAL.EXE - an electronic manual describing the KeyTree Utilities
MANUAL.FIL - which is used by MANUAL.EXE
SAMPLES.EXE - an electronic manual showing some useful examples
SAMPLES.FIL - which is used by SAMPLES.EXE
LOOK.EXE - a program for looking at KeyTree files in detail
(very good for understanding how the KeyTree system works)
CLEANUP.EXE - a program for cleaning up KeyTree files (getting rid of
dead records)
ADDINDEX.EXE - a program for adding additional indexes to an existing
KeyTree file. It is unlikely that you will ever want to
add new keys permanently to a file. However suppose you
had a customer file keyed by customer number, and you
also had a one-off need to access these in post code
sequence. You could use this program to change the key
to post code plus customer number, and use the temporary
file created (TMP1.$$$) for the processing.
CONV2TO3.EXE - a program for converting files created under version 2
of the KeyTree Utilities to the version 3 format. If you
never had version 2, then you certainly don't need this!
SCANPLUS.EXE - a program for finding keyboard scan codes - totally
unrelated to the KeyTree Utilities, but we hope you find
it useful!
ORDER.DOC - print this file and send it to us when you register your
use of the KeyTree Utilities
SHR-WARE.DOC - a description of shareware and the Association of
Shareware Professionals
COMPILING THE KEYTREE UTILITIES
_______________________________
1. If your compiler does not support multiple source files, then the
first line of your program should be
#include "keytree3.c"
2. Since most compilers do support multiple source files, it is more
sensible to compile KEYTREE3.C as a separate object file. In this
case, the first line of any source file that uses the KeyTree
Utilities should be
#include "ktree3.h"
WARRANTY & SUPPORT
__________________
Whilst we have taken every care to ensure that the KeyTree Utilities work
as specified, there is an ancient programmers saying - "Every program
contains at least one bug!". We don't propose to enter into a deep
philosophical discussion on the truth or otherwise of this saying, but
it is a brave man indeed who offers any warranty on the accuracy of
software. Therefore, in common with every other software supplier we
have ever come across, we offer no particular warranty regarding the
use of the KeyTree Utilities, and it is your responsibility to ensure
that your programs, which use the KeyTree Utilities, work.
However, in the unlikely event that you find some combination which does
not do what you expected, we want to hear from you. Please write to us
at the address below, and we will endeavour to explain the problem.
The KeyTree Utilities has been tested using the following compilers :
Borland Turbo C++ version 1.01
Zortech C++ version 2.1
Microsoft QuickC version 2.0
Watcom Express C version 7.0
Mix Power C version 1.2.0
Since this is a fairly representative selection of compilers, the
KeyTree Utilities should be acceptable to any compiler which claims
ANSI compatibility. This does not include Mix C Works, which does
not support the int86 function amongst other anomalies. If your
compiler throws up any warning messages (or, heaven forfend, error
messages) please let us know.
COPYRIGHT & (ABSENCE OF) ROYALTIES
__________________________________
The copyright in KeyTree Utilities (which includes all the files listed
above) is the property of Rewse Consultants Limited. You may make as
many copies of the KeyTree Utilities as you wish, BUT -
i) you may not SELL the KeyTree Utilities to any third party and
ii) if you GIVE the KeyTree Utilities to any third party, you MUST
give them all of the files listed above, particularly this one,
and the same conditions apply to the third party.
In other words, we are impoverished programmers trying to earn an
honest crust, and you wouldn't want to deprive our children of a new
pair of shoes, would you?
No royalty is expected for programs which you create using the KeyTree
Utilities and then distribute to third parties as executable files.
However, we would be interested to hear about your use of the software.
The KeyTree Utilities are issued as shareware. In case you are unaware of
how the shareware system works, it is NOT 'free' software. No initial
charge is made for the software, so that you can try it out without
obligation. However, if you continue to use the software (and in the case
of the KeyTree Utilities, use programs created using them), then you are
required to pay a registration fee. If you don't think the KeyTree
Utilities are worth the registration fee..... well, thanks for your
interest. Just stop using them, and you don't owe us a thing. A more
detailed description of shareware can be found in the file SHR-WARE.DOC.
To register your use of the software, we ask you to pay a miserly
£30 (UK Pounds), a mere fraction of the amount that you are saving
in time and effort.
Please send your registration fee to :
Rewse Consultants Limited
44, Horseshoe Road, Pangbourne, Reading, Berkshire RG8 7JL,
United Kingdom
You can pay the registration fee by Visa or Mastercard - just send us the
account number and date of expiry, and sign the letter authorising us to
charge it to your account.